More documentation fixes

diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 531f05e528df5e46417d350570ca8bf0834a62bc..27bb480c3be5cd5edf8692c74beb5fbcbfb42061 100644 (file)
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -5282,6 +5282,7 @@ gtk_widget_queue_draw
 gtk_widget_queue_resize
 gtk_widget_queue_resize_no_redraw
 gtk_widget_get_frame_clock
+gtk_widget_get_scale_factor
 GtkTickCallback
 gtk_widget_add_tick_callback
 gtk_widget_remove_tick_callback
@@ -6636,6 +6637,7 @@ gtk_icon_theme_lookup_icon_for_scale
 gtk_icon_theme_choose_icon
 gtk_icon_theme_choose_icon_for_scale
 gtk_icon_theme_lookup_by_gicon
+gtk_icon_theme_lookup_by_gicon_for_scale
 gtk_icon_theme_load_icon
 gtk_icon_theme_load_icon_for_scale
 gtk_icon_theme_load_surface
@@ -6705,6 +6707,7 @@ gtk_icon_set_new_from_pixbuf
 gtk_icon_set_ref
 gtk_icon_set_render_icon
 gtk_icon_set_render_icon_pixbuf
+gtk_icon_set_render_icon_surface
 gtk_icon_set_unref
 gtk_icon_size_lookup
 gtk_icon_size_lookup_for_settings

diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index 2ce68fdbe1be8d24bd5af0b52b47aac1ee4b3b9a..e9c9838ead4a506045e53e8b6670dc605e225810 100644 (file)
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -5200,8 +5200,8 @@ gtk_icon_theme_lookup_by_gicon (GtkIconTheme       *icon_theme,
  * The icon can then be rendered into a pixbuf using
  * gtk_icon_info_load_icon_for_scale ().
  *
- * Return value: (transfer full): a #GtkIconInfo structure containing 
- *     information about the icon, or %NULL if the icon 
+ * Return value: (transfer full): a #GtkIconInfo structure containing
+ *     information about the icon, or %NULL if the icon
  *     wasn't found. Unref with g_object_unref()
  *
  * Since: 3.10

diff --git a/gtk/gtkplacessidebar.c b/gtk/gtkplacessidebar.c
index da6592e3c47354169594f80c222a30da3f5fffe4..7e84cb42356f4d95c360765579351f661e38661c 100644 (file)
--- a/gtk/gtkplacessidebar.c
+++ b/gtk/gtkplacessidebar.c
@@ -4207,9 +4207,15 @@ gtk_places_sidebar_class_init (GtkPlacesSidebarClass *class)
 /**
  * gtk_places_sidebar_new:
  *
- * Creates a new #GtkPlacesSidebar widget.  The application should connect
- * to at least the #GtkPlacesSidebar::open-location signal to be notified
+ * Creates a new #GtkPlacesSidebar widget.
+ *
+ * The application should connect to at least the
+ * #GtkPlacesSidebar::open-location signal to be notified
  * when the user makes a selection in the sidebar.
+ *
+ * Returns: a newly created #GtkPlacesSidebar
+ *
+ * Since: 3.10
  */
 GtkWidget *
 gtk_places_sidebar_new (void)
@@ -4332,6 +4338,16 @@ gtk_places_sidebar_set_open_flags (GtkPlacesSidebar *sidebar, GtkPlacesOpenFlags
        }
 }
 
+/**
+ * gtk_places_sidebar_get_open_flags:
+ * @sidebar: a #GtkPlacesSidebar
+ *
+ * Gets the open flags.
+ *
+ * Returns: the #GtkPlacesOpenFlags of @sidebar
+ *
+ * Since: 3.10
+ */
 GtkPlacesOpenFlags
 gtk_places_sidebar_get_open_flags (GtkPlacesSidebar *sidebar)
 {
@@ -4602,8 +4618,11 @@ gtk_places_sidebar_remove_shortcut (GtkPlacesSidebar *sidebar, GFile *location)
  * gtk_places_sidebar_list_shortcuts:
  * @sidebar: a places sidebar
  *
- * Return value: (element-type GFile) (transfer full): A #GSList of #GFile of the locations
- * that have been added as application-specific shortcuts with gtk_places_sidebar_add_shortcut().
+ * Gets the list of shortcuts.
+ *
+ * Return value: (element-type GFile) (transfer full):
+ *     A #GSList of #GFile of the locations that have been added as
+ *     application-specific shortcuts with gtk_places_sidebar_add_shortcut().
  * To free this list, you can use
  * |[
  * g_slist_free_full (list, (GDestroyNotify) g_object_unref);

diff --git a/gtk/gtkrevealer.c b/gtk/gtkrevealer.c
index f90479e506764ed9b49d1a11c84716a6c10e4944..09718f318cb127b5f37e7db2432271139b7fd0bb 100644 (file)
--- a/gtk/gtkrevealer.c
+++ b/gtk/gtkrevealer.c
@@ -249,6 +249,15 @@ gtk_revealer_class_init (GtkRevealerClass *klass)
                                                          G_PARAM_READABLE));
 }
 
+/**
+ * gtk_revealer_new:
+ *
+ * Creates a new #GtkRevealer.
+ *
+ * Returns: a newly created #GtkRevealer
+ *
+ * Since: 3.10
+ */
 GtkWidget *
 gtk_revealer_new (void)
 {

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 532a8280f27714376418418a2249c75c9889c9bb..c49fb57e57367880331f185d56610b1ab69c8000 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -15932,7 +15932,7 @@ gtk_widget_class_set_connect_func (GtkWidgetClass        *widget_class,
 }
 
 /**
- * gtk_widget_class_bind_template_child_private_full:
+ * gtk_widget_class_bind_template_child_full:
  * @widget_class: A #GtkWidgetClass
  * @name: The "id" of the child defined in the template XML
  * @internal_child: Whether the child should be accessible as an "internal-child"